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Foreword 



rd , 



This Technical Specification (TS) has been produced by the 3 Generation Partnership Project (3GPP). 

The present document is part 3 of a muhi-part TS covering the 3''' Generation Partnership Project: Technical 
Specification Group Services and System Aspects; Telecommunication Management; Configuration Management, as 
identified below: 

Part 1: "3G Configuration Management: Concept and Requirements"; 

Part 2: "Notification Integration Reference Point: Information Service Version 1"; 

Part 3: "Notification Integration Reference Point: CORBA Solution Set Version 1:1"; 

Part 4: "Notification Integration Reference Point: CMIP Solution Set Version 1:1"; 

Part 5: "Basic Configuration Management IRP Information Model (including NRM) Version 1"; 

Part 6: "Basic Configuration Management IRP CORBA Solution Set Version 1:1"; 

Part 7: "Basic Configuration Management IRP CMIP Solution Set Version 1:1"; 

Part 8: "Name Convention for Managed Objects". 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

X the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 

Configuration Management (CM), in general, provides the operator with the ability to assure correct and effective 
operation of the 3G network as it evolves. CM actions have the objective to control and monitor the actual configuration 
on the Network Elements (NEs) and Network Resources (NRs), and they may be initiated by the operator or by 
functions in the Operations Systems (OSs) or NEs. 

CM actions may be requested as part of an implementation programme (e.g. additions and deletions), as part of an 
optimisation programme (e.g. modifications), and to maintain the overall Quality Of Service (QOS). The CM actions 
are initiated either as a single action on a NE of the 3G network or as part of a complex procedure involving actions on 
many NEs. 

The Itf-N interface for CM is built up by a number of Integration Reference Points (IRPs) and a related Name 
Convention, which realise the functional capabilities over this interface. The basic structure of the IRPs is defined in 
ITU-T Recommendation X.736 [1] and OMG TC Document telecom [2]. For CM, a number of IRPs (and the Name 
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Convention) are defined herein, used by this as well as other specifications for Telecom Management (TM) produced 
by 3GPP. All these are included in 3G TS 32.106 from Part 2 and onwards. 

The present document is Part 3 of 3G TS 32.106 (3G TS 32.106-3) - Notification IRP CORBA Solution Set. 

IRP Solution Set version: The version of this CORBA Solution Set is 1:1, where the first "1" means that it corresponds 
to the Information Service (3G TS 32.106-2 [5]) version 1, and the second "1" means that it is the first CORBA 
Solution Set corresponding to this Information Service version. 
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Scope 



The present document specifies the Common Object Request Broker Architecture (CORBA) Solution Set (SS) for the 
IRP whose semantics is specified in Notification IRP: Information Service (3G TS 32.106-2 [5]). 



References 



The following documents contain provisions, which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. 

[I] ITU-T Recommendation X.736: "Security Alarm Reporting Function". 

[2] OMG TC Document telecom (98-11-01): "OMG Notification Service". 

[3] OMG CORBA services: Common Object Services Specification, Update: November 22, 1996. 

(Clause 4 contains the Event Service Specification.) 

[4] 3G TS 32.106-8: "Name Convention for Managed Objects". 

[5] 3G TS 32. 106-2: "Notification IRP: Information Service". 

[6] 3G TS 32.1 1 1-2: "Alarm IRP: Information Service". 

[7] 3G TS 32.111-3: "Alarm IRP: CORBA Solution Set, version 1:1". 

[8] ITU-T Recommendation X.733: "Alarm Reporting function". 

[9] 3G TS 32.101: "3G Telecom Management principles and high level requirements". 

[10] 3G TS 32.102: "3G Telecom Management architecture". 

[II] 3G TS 32.106-1: "3G Configuration Management: Concept and Requirements". 



Definitions and abbreviations 



3.1 Definitions 

For the purposes of the present document, the following terms and definitions apply: Please refer to 3G TS 32.101 [9], 
3G TS 32.102 [10] and 3G TS 32.106-1 [11]. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CM Configuration Management 

CORBA Common Object Request Broker Architecture (OMG) 

EC Event channel (OMG) 

IDL Interface Definition Language (OMG) 

IS Information Service 
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NC 

NE 

NV 

EM 

OMG 

SS 

UML 



Notification Channel (OMG) 

Network Element 

Name and Value pair 

Element Manager 

Object Management Group 

Solution Set 

Unified Modelling Language (OMG) 



4 Architectural features 

The overall architectural feature of Notification IRP is specified in 3G TS 32.106-2 [5]. This clause specifies features 
that are specific to the CORBA Solution Set (SS). 



4.1 



Notification services 



In the CORBA Solution Set, notifications are emitted by IRP Agent using CORBA Notification service (OMG TC 
Document telecom [2]). 

CORBA Event service (OMG CORBA services [3]) provides event routing and distribution capabilities. CORBA 
Notification service provides, in addition to Event service, event filtering and support for Quality Of Service (QOS) as 
well. 

A subset of CORBA Notification services shall be used to support the implementation of notification. This CORBA 
Notification service subset, in terms of OMG Notification service (OMG TC Document telecom [2]) defined methods, 
is identified in the present. 

4.1 .1 Support of Push and Pull Interface 

The IRP Agent shall support the OMG Notification push interface model. Additionally, it may support the OMG 
Notification pull interface model as well. 

4.1 .2 Support of multiple notifications in one push operation 

For efficiency, IRP Agent uses the following OMG Notification Service (OMG TC Document telecom [2]) defined 
interface to pack multiple notifications and push them to IRPManager using one method 

push_structured_events. The method takes as input a parameter of type EventBatch as defined in the OMG 
CosNot i f icat ion module (OMG TC Document telecom [2]). This data type is a sequence of Structured Events 
(see clause 4). Upon invocation, this parameter will contain a sequence of Structured Events being delivered to 
IRPManager by IRP Agent to which it is connected. 

The maximum number of events that will be transmitted within a single invocation of this operation is controlled by 
IRP Agent wide configuration parameter. The amount of time IRP Agent will accumulate individual events into the 
sequence before invoking this operation is controlled by IRP Agent wide configuration parameter as well. 

IRP Agent may push EventBatch with only one Structured Event. 

The OMG Notification service (OMG TC Document telecom [2]) defined IDL module is shown below. 

module CosNotifyComm { 

Interface SequencePushConsumer : NotifyPublish { 
void push_structured_events ( 

in CosNotification :: EventBatch notifications) 
raises ( CosEventComm: : Disconnected) ; 

} ; // SequencePushConsumer 
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} ; // CosNotifyComm 



5 Mapping 

5.1 Operation mapping 

Notification IRP: IS (3G TS 32.106-2 [5]) defines semantics of operations visible across this IRP. 

Table 1 maps the operations defined in Notification IRP: IS (3G TS 32.106-2 [5]) to their equivalents (methods) in this 
Solution Set (SS). It also qualifies if a method is Mandatory (M) or Optional (O). 

Table 1 : Mapping from IS Operation to SS Equivalents 



IS Operations in 
3GTS 32.106-2 [5] 


SS Methods 


Qualifier 


subscribe 


attach_push, attach_push_b, attach_pull 


M, 0, 


unsubscribe 


detach 


M 


get Notification 
IRPVersion 


get_notif ication_IRP_version 


M 


get Subscription 
Status 


get_subscription_status 





get Sub script ion Ids 


get_subscription_ids 





change 

Subscription 

Filter 


If subscription is established using attach_push method, the SS equivalent shall 
be change_subscription_f liter . The IDL specification Of this method is 
included in Annex A. This method is Optional (0). 

If subscription is established using attach_push_b method, the SS equivalent 
shall be modify_constraints. The method is defined in OMG Notification 
Service Filter Interface (OMG TO Document telecom [2]). The IDL specification of 
this method is not included in Annex A. If IRPAgent supports the optional 
attach_push_b method, it Shall support this method as mandatory. 

If subscription is established using attach__puii method, the SS equivalent shall 
be modify_constraints. The method is defined by OMG Notification Service 
Filter Interface (OMG TC Document telecom [2]). The IDL specification of this 
method is not included in Annex A. If IRPAgent supports the optional 
attach_puii method, it shall support this method as mandatory. 


See box on 
the left. 


suspend 
Subscription 


If subscription is established using attach_push, there is no SS equivalent. In 
other words, IRPManager cannot suspend subscription. 

If subscription is established using attach_push_b, the SS equivalent shall be 
suspend_connection . This method is defined by OMG Notification Service 
(OMG TO Document telecom [2]). The IDL specification of this method is not 
included in Annex A. If IRPAgent supports the optional attach_push_b method, 
it shall support this method as mandatory. 

If subscription is established using attach_puii, there is no SS equivalent. 


See box on 
the left 


resume 

Subscription 


If subscription is established using attach_push, there is no SS equivalent. In 
other words, IRPManager cannot resume subscription. 

If subscription is established using attach_push_b, the SS equivalent shall be 
resume_connection . This method is defined by OMG Notification Service 
(OMG TO Document telecom [2]). The IDL specification of this method is not 
included in Annex A. If IRPAgent supports the optional attach_push_b method, 
it shall support this method as mandatory. 

If subscription is established using attach_puii, there is no SS equivalent. 


See box on 
the left 


get Notification 
Categories 


get_notification_categories 
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5.2 Operation parameter mapping 

3G TS 32.106-2 [5] defines semantics of parameters carried in operations across the Notification IRP. Table 2 through 
table 12 indicate the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 2: Mapping from IS subscribe parameters to SS attachjjush equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


manager Reference 


Object manager_reference 


M 


timeTick 


long time_tick 





notification 
Categories 


NotificationCategorySet notification_category_set 





filter 


string filter (See NOTE) 





subscript ion Id 


Return value of type Subscription Id 


M 


status 


Attach, ParameterNotSupported, InvalidParameter, AireadySubscribed, 
At LeastOneNotificationCategoryNot Supported 


M 


NOTE: The grammar of the filter string is extended_TCL defined by OIVIG Notification Service (OIVIG TC Document 
telecom [2]). This grammar shall be the only one used for Alarm IRP: CORBA SS. 



Table 3: Mapping from IS subscribe parameters to SS attach_j)ush_b equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


manager Reference 


Object manager_reference 


M 


timeTick 


long time_tick 





notification 
Categories 


NotificationCategorySet notification_category_set 





filter 


string filter 





subscript ionid 


Return value of type Subscription Id 


M 


Not specified in IS 


CosNotifyChannelAdmin::SequenceProxyPushSupplier system reference 

(See NOTE) 


M 


status 


Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, 

AireadySubscribed, 

At LeastOneNotificationCategoryNot Supported 


M 


NOTE: IRPAgent provides this reference to which IRPIVIanager can invoke methods to manage the subscription. 

Valid methods are not defined in this IRP. OIVIG CORBA Notification Service defines these methods. Read 

interface SequencePushSuppller :proxySupplier, CosNotif yComm: : SequencePushSupplier{}. 

IRPManager is expected to invoke connect_sequence_push_consumer ( ) of this interface to connect its 
own cosNotif yComm::sequencePushConsummer with this reference. After successful connection, 
IRPAgent pushes sequence of Structured Events towards IRPManager. 



Table 4: Mapping from IS subscribe parameters to SS attach_pull equivalents 



IS Operation parameter 


SS IVIethod parameter 


Qualifier 


manager Reference 


Object manager_reference 


M 


timeTick 


long time_tick 





notification 
Categories 


NotificationCategorySet notification_category_set 





filter 


string filter 





subscript ionId 


Return value of type Subscription Id 


M 


Not specified in IS. 


CosNotifyChannelAdmin::SequenceProxyPullSuppliersystem_reference 


M 


status 


Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, 

AireadySubscribed, 

At LeastOneNotificationCategoryNot Supported 


M 
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Table 5: Mapping from IS unsubscribe parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Reference 


Object manager_reference 


M 


subscript ion Id 


string subscription_id 





status 


Detach, InvalidParameter 


M 



Table 6: Mapping from IS getNotif icationiRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumber 
List 


Return value of type CommonlRPConstDef s : : VersionNumberSet 


M 


status 


GetNotif icationiRPVersion, InvalidParameter 


M 



Table 7: Mapping from IS getsubscriptionstatus parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscript ion Id 


string subscription_id 


M 


notification 
CategoryList 


Return value of type 

Notif icationlRPConstDef s : : Notif icationCategorySet 


M 


filterlnEffect 


string f ilter_in_ef f ect 





subscription 
State 


Notif icationlRPConstDef : : SubscriptionState 
subscription_state 





timeTick 


long time_tick 





status 


Getsubscriptionstatus, OperationNotSupported, InvalidP 
arameter 


M 



Table 8: Mapping from IS getSubscrlptlonids parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


manager Reference 


Object manager_reference 


M 


subscriptionldList 


Return value of type 

Notif icationlRPConstDef s : : SubscriptionldSet 


M 


status 


GetSubscriptionlds, OperationNotSupported, InvalidPara 
meter 


M 



Table 9: Mapping from IS changeSubscrlptlonFllter parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscript ion Id 


string subscription_id 


M 


filter 


string filter 


M 


status 


ChangeSubscrlptlonFllter, OperationNotSupported, Inval 
idParameter 


M 



£75/ 



3G TS 32.106-3 version 3.1.0 Release 1999 



11 



3G TS 32.106-3 version 3.1.0 (2000-07) 



Table 10: Mapping from IS suspendSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and requires no parameter. Therefore, there 

is no SS equivalent for this IS parameter. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is established using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

suspend_connection. This method is defined by OMG Notification Service 

(OMG TC Document telecom [2]) and it returns a void. Therefore, there is no 

SS equivalent for this IS parameter. This suspend_connection method can 

raise OMG Notification Service (OMG TC Document telecom [2]) defined 

exception called ConnectionAlreadylnactive. 

If subscription is established using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 11 : Mapping from IS resumeSubscription parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


subscriptionid 


If subscription is estabUshed using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is established using attach_push_b, the SS equivalent method is 

resume_connection. This method is defined by OMG Notification 

Service (OMG TC Document telecom [2]) and requires no parameter. 

Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 


status 


If subscription is estabUshed using attach_push, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 

If subscription is estabUshed using attach_push_b, the SS equivalent 

method is resume_connection. This method is defined by OMG 

Notification Service (OMG TC Document telecom [2]) and returns a void. 

Therefore, there is no SS equivalent for this IS parameter. This 

resume_connection method can raise OMG Notification Service (OMG 

TC Document telecom [2]) defined exception called 

Connect ionAlreadyActive. 

If subscription is estabUshed using attach_pull, there is no SS equivalent 

method. Therefore, there is no SS equivalent for this IS parameter. 


M 



Table 12: Mapping from IS getNotificationCategories parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


notification 
CategoryList 


Return value of type 

Notif icationlRPConstDef s : : Notif icationCategorySet 


M 


eventTypeList 


NotificationlRPConstDefs: : Event Types Set 
event_type_list 





extendedEvent 
TypeList 


NotificationlRPConstDefs: : ExtendedEvent Types Set 
extended_event_type_list 





status 


GetNotificationCategories, Ope r at ionNot Supported 


M 
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5.3 Notification parameter mapping 



Notification IRP: IS (3G TS 32.106-2 [5]) defines a generic notify and its parameters. This SS does not provide the 
mapping of these parameters to their CORB A SS equivalents. 

Other IRPs using the Notification IRP such as Alarm IRP: IS (3G TS 32. 1 1 1 -2 [6]) extend the generic notify for their 
specific use. Their corresponding SS documents shall define the mapping from their specific notification parameters 
(defined in their IS document) to their SS equivalents. These SS documents shall qualify their SS equivalents as well. 



5.4 Attribute mapping 



Notification IRP: IS (3G TS 32.106-2 [5]) defines the semantics of common attributes carried in notifications. This SS 
does not provide the mapping of these attributes to their CORBA SS equivalents. Other IRPs such as Alarm IRP: 
IS (3G TS 32. 11 1-2 [6]) identify and qualify these common attributes for use in their environment. Their corresponding 
SS documents define the mapping of these attributes to their SS equivalents. 



6 Use of OIVIG Notification structuredEvent 

Notification IRP: IS (3G TS 32.106-2 [5]) defines attributes that are commonly present in notifications of all 
notification categories such as notifications emitted from Alarm IRP IRP Agent. 

In CORBA SS, OMG defined StructuredEvent (OMG TC Document telecom [2]) is used to carry notification. 
This clause identifies the OMG defined StructuredEvent attributes that carry the common attributes defined in 
3GTS 32.106-2 [5]. 

The composition of OMG StructuredEvent is: 

Header 

Fixed Header 

Domain_name 
TYpe_name 
Event_name 
Variable Header 
Body 

Filterable_bodY_f ields 
Remaining_body 
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Table 13 shows the OMG Structured Event attributes (middle column) that are used to carry the common notification 
attributes defined in Notification IRP: IS (3G TS 32.106-2 [5]). 

Table 13: Attributes of structuredEvent 



Common 

attributes defined 

in Notification 

IRP: IS 

(30 TS 32.106-2 

[5]) 


Attribute 

defined by 

OMG 

structured 
Event 


Comment 


There is no 
corresponding SS 
attribute. 


domain_name 


It indicates that the StructuredEvent, carried in the Notification, is defined by a specific 
3GPP IRP such as Alarm IRP, as opposed to OMG specified Telecommunication, healthcare, 
utility, finance, etc. It indicates the CORBA SS version number as well. 

It is a string. Legal values are defined in module. 

For Alarm IRP version 1:1, the value is ALARM_IRP_VERSI0N_1_1 . 


eventType 


type_name 


It indicates event types of this notification. The semantics of the event type is defined by 
ITU-T TMN Recommendations. Each IRP, such as Alarm IRP IS version 1, shall identify 
the ITU-T defined event types for their use. Each such IRP document shall define the values 
of the identified event Types as well. 

Dependent on the notification category, possible legal values are: 

COMMUNICATIONS_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
QUALITY_OF_SERVICE_ ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
PROCESSING_ERROR_ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
EQUIPMENT. ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
ENVIRONMENTAL. ALARM (clause 8.1.1 of ITU-T Recommendation X.736 [8]), 
PHYSICAL_VIOLATION (ITU-T Recommendation X.736 [1]), 
INTEGRITY. VIOLATION (ITU-T Recommendation X.736 [1]), 
SECURITY, VIOLATION (ITU-T Recommendation X.736 [1]), 
TIME_DOMAIN_ VIOLATION (ITU-T Recommendation X.736 [1]), 
OPERATIONAL_VIOLATION (ITU-T Recommendation X.736 [1]). 

The bracketed number of each type indicates the reference where the semantics of the type is 

specified. 

It is a string. See eacti individual CORBA SS IDL module for each IRP using the 

Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of event type, the 

values specified by each IRP are only unique within one IRP. For uniqueness 

among all IRPs' specifications, the values of event type shall be coupled with the 

notification category, the value carried in domain name of the same notification. 


extended 
EventType 


event_name 


The legal values carried in this attribute are specified by the IRP using the notification. For 
example. Alarm IRP: CORBA SS (3G TS 32. 111-3 [7]) defines and uses the following 
values: 

NOTIFY_FM_NEW_ALARM, 
NOTIFY_FM_CHANGED_ALARM, 
NOTIFY_FM_ACK_STATE_CHANGED, 
NOTIFY_FM_CLEARED_ALARM and 
NOTIFY_FM_ALARM_LIST_REBUILT. 

It is a string. See each individual CORBA SS IDL module for each IRP using the 
Notification IRP, for legal values used by that IRP version. 

Since each IRP except Notification IRP specifies its own set of extended event type, the 
values specified by each IRP are only unique within one IRP. For uniqueness among all 
IRPs' specification, the values of extended event type shall be coupled with the notification 
category, the value carried in domain_name of the same notification. 


There is no 
corresponding SS 
attribute. 


variable Header 




managed 
Object 


One NV (name- 
value) pair of 


Name of NV pair is a string, NV_MANAGED_OBJECT_INSTANCE. 

Value of NV pair is a string. Syntax and semantics of this string conform to the Managed 
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Common 

attributes defined 

in Notification 

IRP: IS 

(30 TS 32.106-2 

[5]) 


Attribute 

defined by 

OMG 

structured 
Event 


Comment 


Class, 
managed 
Object 
Instance 


filterable_ 
bodyjields 


Object string representation specified in (3G TS 32.106-8 [4]). Note that two SS attributes 
are carried in this one NV pair since the string representation specified in 3G TS 32.106-8 [4] 
can convey the semantics of managedObjectClass and managedObjectlnstance in one 
string. 


notification 
Id 


One NV pair of 
filterable_ 
body fields 


Name of NV pair is a string, NV_NOTIFICATION_ID. 
Value of NV pair is an unsigned long. 


eventlime 


One NV pair of 
filterable_ 
body fields 


Name of NV pair is a string, NV_EVENT_TIME. 
Value of NV pair is an IRPTime. 


systemDN 


One NV pair of 
filterable_ 
body fields 


Name of NV pair is a string, NV_SYSTEM_DN. 

Value of NV pair is a string. Syntax and semantics of this string conforms to the Managed 

Object string representation specified in 3G TS 32.106-8 [4]. 


There is no 
corresponding SS 
attribute. 


remaining_ Body 





7 IRPAgent's Behaviour 

This clause describes some IRPAgent's behaviour not captured by IDL. 



7.1 



Subscription 



IRPManager can invoke muhiple at tach_push, muhiple attach_push_b or muhiple attach_pull using 
different manager_ref erence(s). As far as IRP Agent is concerned, the IRP Agent will emit notifications to 
multiple "places" with their independent filter requirements. IRP Agent will not know if the notifications are going to 
the same IRPManager. 

If IRPManager invokes multiple at tach_push, attach_push_b or attach_pull using the same 
manager_ref erence and with an already subscribed notif ication_category, IRP Agent shall raise 
AlreadySubscribed exception to all invocations except one. 

IRPManager can invoke multiple attach_push using the same manager_ref erence and with one or more not- 
yet-subscribed notif ication_categories. In this case, if IRP Agent supports all the notification categories 
requested, IRP Agent shall accept the invocation; otherwise, it raises 
AtLeastOneNotif icationCategoryNotSupported exception. IRP Agent shall have similar behaviour for 

attach_push_b and attach_pull. 

When IRPManager is in subscription by invoking attach_push, IRPManager can change the filter constraint, using 
change_subscription_f ilter, applicable to the notification categories specified in the attach_push. 

When IRPManager is in subscription by invoking attach_push_b, IRPManager can change the filter constraint 
during subscription using the OMG defined Notification Service Filter Interface. IRPManager shall not use 

change_subscription_f ilter; otherwise it shall get an exception. 

7.2 IRPAgent supports multiple categories of Notifications 

IRP Agent may emit multiple categories of Notifications. IRPAgent may have mechanism for IRPManager to pull for 
notifications of multiple categories. 

IRPManager can query IRPAgent about the categories of notifications supported by using 

get_notif ication_categories. 
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IRPManager uses a parameter, notif ication_categories, in attach_push, attach_push_b and 
attach_pull to specify one or more categories of notifications wanted. 

IRPManager uses a zero-length sequence in notif ication_categories of attach_push, attach_push_b 
and attach_pull to specify that all IRP Agent supported categories of notifications are wanted. If IRPManager uses 
attach_push with zero-length sequence in notif ication_categories and if the operation is successful, 
IRP Agent shall reject subsequent attach_push operation, regardless if the notif ication_categories 
contains a zero-length sequence or one or more specific notification categories. IRP Agent shall have similar behaviour 
for attach_push_b and attach_pull. 

7.3 IRPAgent's integrity risk of attach_push_b IVIethod 

In the case that IRP Agent implements this method by extending or using OMG compliant Notification Service, the 
following IRPManager behaviour illustrates a risk to IRPAgent's integrity. 

Given the object reference (lOR) of the SequenceProxyPushSupplier (as the mandatory output parameter of the 
subject method), IRPManager can invoke SequenceProxyPushSupplier. MyAdmin method. 

IRPManager can then obtain the consumer admin object of the proxy. Then IRPManager can invoke 
consumerAdmin.MyChannel to get the lOR of the Notification Channel. IRPManager then can call 
eventChannel .MyFactory which will provide IRPManager the lOR of the EventChannelFactory itself. 
IRPManager can then able to invoke methods directly on the EventChannelFactory, like get_all_channels 
which lists all channel numbers and create_channel which allows IRPManager to create any number of additional 
channels. 

A malicious IRPManager can, given access to the EventChannelFactory, get a list of existing channels and start 
connecting them together at random thus compromising the IRPAgent's integrity. Deployment of this 
attach_push_b needs strong authentication and authorisation mechanism in place. 

attach_push is mandatory. IRP Agent compliant to this IRP shall implement it. 

attach_push_b is optional. It is recommended that IRP Agent concerned with integrity risk should not implement 
the attach_push_b option. 



8 Example of Notification related to alarm 

The following is an example of Notification related to alarm. 

If type_name == NOTIFY_FM_NEW_ALARM, then the f ilterable_body_f ield attributes can contain: 

{ 

systemDN, "..."; 
alarmld, "abce232", 

notif icationid, 4457, 
managedOb jectlnstanoe, "...", 

eventTime, ..., 
probableCause, 3, 
peroeivedSeverity , 2, 
specif icProblems, "xxx", 
additionalText, "...", 
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Annex A (normative): 
Notification IRP CORBA IDL 



/* ## Module: CommonlRPConstDef s 

This module contains definitions commonly used among all IRPs such as Alarm IRP. 

V 

#ifndef CommonlRPConstDef s_idl 
#define CommonlRPConstDef s_idl 
#include <TimeBase . idl> 

module CommonlRPConstDef s { 

/* 

Definition imported from CosTime. The time refers to time in Greenwich 

Time Zone. It also consists of a time displacement factor in the form 

of minutes of displacement from the Greenwich Meridian. 

V 

typedef TimeBase : : UtcT IRPTime; 

enum Signal {OK, Failure, PartialFailure } ; 

typedef sequence <string> VersionNumberSet ; 

}; 

#endif 



/* ## Module: Notif icationlRPConstDef s 

This module contains definitions specific to Notification IRP. 

V 

#ifndef Notif IcationlRPConstDef s_idl 
# define Notif IcationlRPConstDef s_idl 

module Notif IcationlRPConstDef s { 

/* 

This is a string sequence identifying notification categories. 

A notification category is identified by the IRP name and its version. 

V 

typedef sequence <string> Notif icationCategorySet; 

/* 

This is a sequence of strings identifying event types of a particular 

notification category. 

V 

typedef sequence <string> EventTypesPerNotif icationCategory; 

/* 

This sequence identifies all event types of all notification categories 

identified by Notif IcationCategorySet . The number of elements in this 

sequence shall be identical to that of Notif IcationCategorySet . 

V 

typedef sequence <EventTypesPerNotif icationCategory> EventTypesSet ; 



£75/ 



3G TS 32.1 06-3 version 3.1 .0 Release 1 999 17 3G TS 32.1 06-3 version 3.1 .0 (2000-07) 



/* 

This is a sequence of strings identifying extended event types of 

a particular notification category. 

V 

typedef sequence <string> ExtendedEventTypePerNotif icationCategory; 

/* 

This sequence identifies all extended event types of all notification 
categories identified by Notif icationCategorySet . The number of elements 
in this sequence shall be identical to that of Notif IcationCategorySet . 
V 

typedef sequence <ExtendedEventTypePerNotif icationCategory> 
ExtendedEventTypesSet ; 

typedef sequence <long> NotiflDSet; 

/* 

This holds identifiers of notifications that are correlated. 

V 

struct CorrelatedNotif ication { 

string source; // Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI parameter-attribute 
// of the Structured Event, i.e., the notification. 
NotiflDSet notiflDSet; 



/* 

Correlated Notification sets are sets of Correlated Notification 

structures . 

V 

typedef sequence <CorrelatedNotif ication> CorrelatedNotif icationSetType; 

/* 

This is a sequence of strings identifying Subscription Ids. 

V 

typedef string Subscriptionid; 

typedef sequence <SubscriptionId> SubscriptionldSet ; 

/* 

This block encapsulates valid strings carried in domain_name of 

structured event header. It carries the name of IRP and its 

corresponding CORBA SS version number. They are the returned 

values for get_XXX_IRP_version ( ) as well. 

V 

const string ALARM_IRP_VERSI0N_1_1 = "Ifl"; //alarm IRP 1:1 

const string C0NFIGURATI0N_IRP_VERSI0N_1_1 = "Id"; //CM IRP 1:1 



/* 

This string is used as return value for get_notif ication_irp_version ( ) 

V 

const string N0TIFICATI0N_IRP_VERSI0N_1_1 = "Inl"; //Notification IRP 1:1 



/* 

This block encapsulates string used in the name of the Name Value 
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pair of the structured event. 
V 

const string NV_NOTIFICATION_ID = "a"; 

const string NV_CORRELATED_NOTIFICATIONS = "b"' 

const string NV_EVENT_TIME = "c"; 

const string NV_SYSTEM_DN = "d"; 

const string NV_MANAGED_OBJECT_CLASS = "e"; 

const string NV_MANAGED_OBJECT_INSTANCE = "f"; 



const string NV_PERCEIVED_SEVERITY = "h 
const string NV_SPECIFIC_PROBLEM = "i 



"h"; 



H o " ■ 



const string NV_ALARM_id = "k"; 
const string NV_ACK_USER_ID = "1"; 
const string NV_ACK_TIME = "m"; 
const string NV_ACK_SYSTEM_ID = "n"; 
const string NV_ACK_STATE = "o"; 
const string NV_BACKED_UP_STATUS = ' 
const string NV_BACK_UP_OBJECT = "q' 
const string NV_THRESHOLD_INFO = "r' 
const string NV_TREND_INDICATION 
const string NV_STATE_CHANGE_DEFINITIONS = 
const string NV_MONITORED_ATTRIBUTES = "u' 
const string NV_PROPOSED_REPAIRED_ACTIONS 



/* 

This indicates if the subscription is active (not suspended) or inactive. 

V 

enum SubscriptionState {Inactive, Active, DontKnow}; 



}; 

#endif 



/* ## Module: Notif icationlRPSystem 

This module implements capabilities of IRPAgent specified in Notification 
IRP: Information Service version 1 and its equivalents in Notification 
IRP: CORBA Solution Set version 1:1. 

V 

#if ndef Notif icationIRPSystem_idl 
# define Notif icationIRPSystem_idl 

#include "CosNotifyComm. idl" 

# include "CosNotif yChannelAdmin . idl" 

#include "Notif IcationlRPConstDefs . idl" 

#include "CommonlRPConstDef s . idl" 



module Notif icationlRPSystem { 

/* 

System fails to complete the operation. System can provide reason 
to qualify the exception. The semantics carried in reason 
is outside the scope of this IRP. 
V 
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exception Attach { string reason; } ; 
exception DetachException { string reason; }; 

exception GetSubscriptionStatus { string reason; }; 
exception GetSubscriptionlds { string reason; }; 
exception ChangeSubscriptionFilter { string reason; }; 
exception GetNotif icationCategories { string reason; }; 

exception ParameterNotSupported { string parameter; }; 

// name of the unsupported parameter as defined in IDL 

exception InvalidParameter { string parameter; }; 

// name of the parameter as defined in IDL 

exception OperationNotSupported {}; 

exception AlreadySubscribed {}; 

exception AtLeastOneNotif icationCategoryNotSupported {}; 

interface Notif icationlRPOperations { 

/* ## Operation: attach_push 

V 

Notif icationlRPConstDef s :: Subscriptionid attach_push ( 

in Object manager_ref erence, 

in long time_tick, 

in Notif icationCategorySet notif ication_category_set, 

in string filter 
) 

raises (Attach, ParameterNotSupported, InvalidParameter, AlreadySubscribed, 
AtLeastOneNotif IcationCategoryNotSupported) ; 

/* ## Operation: attach_push_b 
V 

Notif icationlRPConstDef s :: Subscriptionid attach_push_b ( 
in Object manager_ref erence, 
in long time_tick, 

in Notif IcationCategorySet notif ication_category_set, 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPushSupplier system_ref erence 
) 

raises 
(Attach, OperationNotSupported, ParameterNotSupported, InvalidParameter, Already Subs 
cribed, AtLeastOneNotif IcationCategoryNotSupported) ; 

/* ## Operation: attach_pull 
V 

Notif icationlRPConstDef s :: Subscriptionid attach_pull ( 
in Object manager_ref erence, 
in long time_tick, 

in Notif IcationCategorySet notif ication_category_set , 
in string filter, 

out CosNotif yChannelAdmin : : SequenceProxyPullSupplier system_ref erence 
) 

raises (Attach, OperationNotSupported, ParameterNotSupported, 
InvalidParameter, AlreadySubscribed, 
AtLeastOneNotif IcationCategoryNotSupported) ; 

/* ## Operation: detach 
V 
void detach ( 

in Object manager_ref erence, 

in string subscription_id 
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raises (DetachException, InvalidParameter) ; 

/* ## Operation: get_notif ication_IRP_version 

V 

CommonlRPConstDef s : : VersionNumberSet get_notif ication_IRP_version () 



/* ## Operation: get_subscription_status 
V 
Notif icationlRPConstDef s : : Notif icationCategorySet get_subscription_status ( 

in string subscription_id, 

out string f ilter_in_ef f ect , 

out Notif icationlRPConstDef s : : SubscriptionState subscription_state, 

out long time_tick 
) 
raises (GetSubscriptionStatus, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_subscription_ids 

V 

Notif IcationlRPConstDef s : : SubscriptionldSet get_subscription_ids ( 

in Object manager_ref erence 
) 
raises (GetSubscriptionlds, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: change_subscription_f liter 
V 
void change_subscription_f ilter ( 

in string subscription_id, 

in string filter 
) 
raises (ChangeSubscriptionFllter, OperationNotSupported, InvalidParameter) ; 

/* ## Operation: get_notif ication_categories 
V 

Notif IcationlRPConstDef s : : Notif IcationCategorySet 
get_notif ication_categories ( 
out Notif IcationlRPConstDef s :: EventTypesSet event_type_list , 
out Notif icationlRPConstDef s : : ExtendedEventTypesSet 
extended_event_type_list 
) 
raises (GetNotificationCategories, OperationNotSupported) ; 



}; 

#endif 



£75/ 



3G TS 32.106-3 version 3.1.0 Release 1999 



21 



3G TS 32.106-3 version 3.1.0 (2000-07) 



Annex B (informative): 
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